home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / coding / c / chunker / chunker.doc < prev    next >
Text File  |  1995-11-15  |  10KB  |  326 lines
  1.       ______________      ______________
  2.      /             /     /_/_/_/_/_/_/_/   Chunker 1.2 <--> DeChunk 1.2
  3.     /             /     /_/_/_/_/_/_/_/
  4.    /             /     /_/_/_/_/_/_/_/     A portable method of splitting
  5.   /             / <-> /_/_/_/_/_/_/_/      and joining files.
  6.  /             /     /_/_/_/_/_/_/_/
  7. /_____________/     /_/_/_/_/_/_/_/        Copyright ©1995 Lee Kindness.
  8.  
  9.  
  10. Chunker:
  11. Compiled           Saturday 11 November 1995 13:13:20
  12. Amiga Exe size     2824 bytes
  13. MSDOS Exe size     15458 bytes
  14. Version            Chunker 1.2 (11/11/95)
  15.  
  16. DeChunk:
  17. Compiled           Friday 10 November 1995 22:21:14
  18. Amiga Exe size     2716 bytes
  19. MSDOS Exe size     15229 bytes
  20. Version            DeChunk 1.2 (10/11/95)
  21.  
  22. Distribution built Sunday 12 November 1995 12:13:29
  23.  
  24.  
  25.  LEGAL
  26. -=====-
  27.  
  28.  Disclaimer
  29.  ~~~~~~~~~~
  30.  I hereby reject any liability or responsibility for these or any
  31.  other consequences from the use of Chunker whatsoever. This includes,
  32.  but is not limited to, damage to your equipment, to your data,
  33.  personal injuries, financial loss or any other kinds of side effects.
  34.  Although Chunker has been tested thoroughly on several different
  35.  machines, I cannot rule out the possibility that Chunker:
  36.  
  37.      1. is somehow incompatible to your equipment
  38.      
  39.      2. has bugs that show up on your equipment
  40.      
  41.      3. does not do what it is supposed to do on your equipment
  42.      
  43.      4. May damage you equipment
  44.  
  45.  It is your responsibility to take any precautions necessary to
  46.  protect yourself from these or any other effects. I explicitly
  47.  reject any liability or responsibility from the consequences of you
  48.  using Chunker
  49.  
  50.  Distribution
  51.  ~~~~~~~~~~~~
  52.  
  53.  Chunker may be freely distributed and copied, as long as the following 
  54.  conditions are fulfilled:
  55.  
  56.      1. All parts of the program and the documentation must be complete.
  57.         The distribution of single parts or incomplete subsets of the
  58.         original distribution is forbidden.
  59.         
  60.      2. If Chunker is to be included in a commercial distribution (including
  61.         magazines!) then I must be sent a copy of the product (or if it is a 
  62.         mag that I am subscribed to then an increase in subscription). It 
  63.         would be better if you contacted me beforehand to ensure you have the 
  64.         latest version. In any case full credit must be given within the
  65.         magazine (ie mention my name).
  66.      
  67.      3. If the included source code is used in another program then credit 
  68.         must be given in the documentation.
  69.  
  70.  Note To Magazines
  71.  ~~~~~~~~~~~~~~~~~
  72.  
  73.  In the past I have had some of my programs included on magazine coverdisks
  74.  without my permission when in the documentation it was stated that this
  75.  was required... I want my programs on coverdisks but you _MUST_ read and
  76.  fufil the "Distribution" section above. If you disagree then contact me
  77.  or write a message in the AMIGA_MAGS echo...
  78.  
  79.  
  80.  COMPILATION
  81. -===========-
  82.  
  83.  This archive includes versions of Chunker and DeChunk for the Amiga (chunker
  84.  and dechunk) and MSDOS (CHUNKER.EXE and DECHUNK.EXE). The ANSI C source code 
  85.  is included in the source drawer. This source should complile with all ANSI 
  86.  C compilers. To compile the unix version simply type 'make' in the source
  87.  directory. The makefile does the following:
  88.  
  89.    CC -O2 -o chunker chunker.c machine.c bfn.c
  90.    CC -O2 -o dechunk dechunk.c machine.c bfn.c
  91.       ### ##########
  92.        |      \
  93.  turns |       \ specifies the name of the compiled program
  94.  on level        to create.
  95.  2 optimisation
  96.  
  97.  
  98.  USAGE
  99. -=====-
  100.  
  101.  Chunker is used to split a file up into smaller pieces. It expects the
  102.  following arguments:
  103.  
  104.    chunker <file> <basename> <size>
  105.  
  106.  file: Name of the file to split.
  107.  
  108.  basename: The created split files will have this as their base name. For
  109.     example if you had "ding" as basename then the created files would
  110.     be:
  111.         ding.000
  112.         ding.001
  113.         :
  114.         :
  115.         ding.XXX
  116.     Note that the XXX part is a 3 part hexadecimal number.
  117.  
  118.  size: Size (in bytes) of the created chunks.
  119.  
  120.  For example:
  121.  
  122.    chunker bigfile.gz bigfile 716800
  123.  
  124.  would split the file 'bigfile.gz' into 700k chunks with a basname of
  125.  'bigfile'.
  126.  
  127.  
  128.  DeChunk will reassemble the chunks output by Chunker into the original
  129.  file. It expects the following arguments:
  130.  
  131.    dechunk <outputfile> <basename>
  132.  
  133.  outputfile: Name of the file to create.
  134.  
  135.  basename: The basename of the split files. For example if the first of the 
  136.     split files is called "ding.000" then use "ding". This should be the
  137.     same as you passed as basename to Chunker.
  138.  
  139.  
  140.  NOTE that the amiga version accepts arguments in the normal ReadArgs
  141.  format, just type 'chunker ?' and 'dechunk ?' for the template. The
  142.  Amiga version are also pure and reentrant, and as such can be made
  143.  resident.
  144.  
  145.  
  146.  CONTACT
  147. -=======-
  148.  
  149. Means of contact, as of Sunday 12 November 1995
  150.  
  151. Mail:
  152.   Lee Kindness
  153.   8 Craigmarn Road
  154.   Portlethen Village
  155.   Aberdeen AB1 4QR
  156.   SCOTLAND
  157.  
  158. EMail:
  159.   cs2lk@scms.rgu.ac.uk
  160.   wangi@spuddy.mew.co.uk
  161.   wangi@fido.zetnet.co.uk
  162.   :
  163.   :
  164.   Please use cs2lk@scms.rgu.ac.uk
  165.  
  166. Fidonet:
  167.   2:259/26.20 "Lee Kindness"
  168.  
  169. Amiganet:
  170.   39:138/40.34 "Lee Kindness"
  171.  
  172.  
  173.  LATEST VERSION
  174. -==============-
  175.  
  176.  The latest version of Chunker can always be found on:
  177.  
  178.        _____
  179.       /_____)
  180.      /(___________________________________
  181.     / _____________  ___________________  )
  182.    / /            / (_                  \/   +44-(0)1484-842341
  183.   (__) r o s t   / ___) r e e
  184. \               / /                         Fidonet --- 2:250/366
  185.  \              \/   A m i g a  B B S       Amiganet -- 39:138/40
  186.   \
  187.    \-> Sysop Dave Naylor
  188.     \-> Using Zeus BBS software!
  189.      \-> The biggest UK Amiga BBS
  190.       \-> Points welcome
  191.        \-> 24 hours a day in sunny Yorkshire!
  192.  
  193.  
  194.  Chunker will be in the WANGI file area or you can freq it using the
  195.  magic filename CHUNKER.
  196.  
  197.  
  198.  VERSION HISTORY
  199. -===============-
  200.  
  201. 1.0  : 04.11.95
  202.      + Original version
  203.  
  204. 1.1  : 05.11.95
  205.      + Full documentation added.
  206.  
  207. 1.2  : 10.11.95
  208.      + Added lots of conditional coding... Amiga exe size is now 2.5k
  209.        compared to 12k !!
  210.        
  211.      + Amiga version now accepts readarg arguments.
  212.      
  213.      + Chunker and dechunk Amiga versions are now pure, they can
  214.        be made resident.
  215.      
  216.      + Actually compiled the MSDOS versions... by heck they are
  217.        over 15k in size
  218.  
  219.  
  220.  OTHER PROGRAMS
  221. -==============-
  222.  
  223. SlowBoot:
  224.   Offers a software solution to the problem of slow spin-up IDE drives.
  225.   
  226. FindSystem:
  227.   Searches a nodelist for nodes those names match a wildcard.
  228.  
  229. FindSysop:
  230.   Searches a nodelist for nodes those sysops names match a wildcard.
  231.  
  232. FindPlace:
  233.   Searches a nodelist for nodes those location match a wildcard.
  234.  
  235. FindPhone:
  236.   Searches a nodelist for nodes those phonenumber match a wildcard.
  237.  
  238. NLFind:
  239.   Provides multiline node support for traplist.library. (comm/fido/NLFind.lha)
  240.  
  241. Erase:
  242.   Delete a file for GOOD... you will not be able to recover it!
  243.   (util/cli/Erase.lha)
  244.  
  245. YourFault:
  246.   Replace the system error requesters with your own... "Banana in drive
  247.   DF0:" :)) (util/boot/YourFault.lha, YourFaultSrc.lha, YourFaultStr.lha)
  248.  
  249. CaBoom:
  250.   Windows explode/implode on opening/closing...
  251.   (util/boot/CaBoom.lha)
  252.  
  253. Shrub:
  254.   Creates a directory tree, like Tree from MSDOS but it has a nice Workbench
  255.   GUI, search facility, is very fast and a lot more. (util/wb/Shrub.lha)
  256.  
  257. RubbishDump:
  258.   A replacement for the trashcan... but it has SOUND! So when you delete a
  259.   file a sample is played (can in reality send any ARexx command).
  260.   (util/app/RubbDump.lha)
  261.  
  262. AmigaGuidePrefs: (or AGPrefs to its friends...)
  263.   A complete preference editor for amigaguide. Lets you modify the colours
  264.   of certain attributes (has a preview), type of node and search paths.
  265.   (text/hyper/AmigaGuidePref.lha)
  266.  
  267. WangiPad:
  268.   A powerful launchpad utility (ie. like toolmanger). The new version 2 should
  269.   make WP more powerful than ToolManager... watchout for it!
  270.   (util/wb/WangiPad.lha)
  271.  
  272. Jiggler:
  273.   A WB hack. Makes all window move towards the mouse pointer. 
  274.   (game/gag/Jiggler.lha)
  275.   DROP INTO YOUR 'FRIENDS' WBSTARTUP DRAWER...
  276.  
  277. DQua:
  278.   A simple quadratic equation solver. (misc/math/DQua.lha)
  279.  
  280. MacCash:
  281.   Generates UK lottery numbers. Does not falsely predict them, it is 100% 
  282.   random. It hace a nice Workbench GUI. (misc/misc/MacCash.lha)
  283.  
  284. DefDataTypeIconer: (or DefDTIcon...)
  285.   Lets you change files icons, based on their datatype!
  286.   (pix/icon/DefDTIcon.lha)
  287.  
  288. NewEXT:
  289.   With the AmigaDos rename command you can do "rename #?.txt TO #?.doc" with
  290.   NewEXT you can... (util/batch/NewEXT)
  291.  
  292. Startup-Menu:
  293.   A startup menu/utility. Lets you change the 'startup-sequece' used. Very 
  294.   customisable. (util/boot/Startup-Menu.lha)
  295.  
  296. Bush:
  297.   Like Shrub but Shell only and slower... (util/cli/Bush.lha)
  298.   USE SHRUB.
  299.  
  300. DiceRoll:
  301.   Emulates dice throws... ie. generate random numbers. (util/misc/DiceRoll.lha)
  302.  
  303. Publican:
  304.   PublicScreen utility. (util/misc/Publican.lha)
  305.  
  306. MidMoose:
  307.   Emulates middle mouse button for those with only two buttons on their mice.
  308.   (util/mouse/MidMoose.lha)
  309.  
  310. NaeGrey:
  311.   Makes the grey borders around screens black. (util/misc/naegrey.lha)
  312.   USE A PROGRAM LIKE MultiCX INSTEAD!
  313.  
  314. SFPatch:
  315.   Code showing how to patch Amiga library functions. (dev/c/SFPatch.lha)
  316.  
  317. Torch:
  318.   A blanker module for SwazBlanker.
  319.  
  320.  
  321.  
  322. ---     __      ____     _
  323. Wangi! / /     (  __) /|/ )  Lee Kindness Amiga PD/shareware author
  324.  _____/ (_/\  __\ \  / _ (______________  cs2lk@scms.rgu.ac.uk
  325. (___________)(_____)(__)\_______________) wangi@spuddy.mew.co.uk
  326.